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The B1000 iaplementation of OMS/INQUIRY is standard with respect 
to the CSG INQUIRY STANDARD Crevision 8)>» with the fottowing 
exceptions: | 


NON STANDARD ITENS 


1) Inquiry has no restrictions on which statewents may Ce 


continued with the percent sign (%)5% or forced into the 
current text buffer with the double percent sign (42). 


2) SCALE. truncates trailing fractional parts? - 7t does not 
TOUNG. 


SUBSETS OF THE STANDARD 


1) +. Inquiry does not take advantage cf sets when calculating 
functions. For example» with the following DASDL 
description: | | | | 

DSA STANDARD OATA SETS 
Al NUMBER( 8); 
A2 NUMBERC8&)>5 > 
S51 SET QF OSA KEY IS Als 


the Inquiry statement 
DISPLAY SUMCA2 AT AL > 1060) Woutd not use the 
index Sl even though it would be to its advantage to do so. 
The user may enter | a 
| GENERATE TSL = Al > 19343 OD SUMCA2 VIA TSH) 
to take advantage of the index. 


2) A single input is tlimited to a totat length of 485 
: characters when continued with "%" signs. This is the size 
of the current text buffer. 


3) Inquiry will never output "WAIT™ before starting a long 
operatione. 


4) <boolean item>s have not been implemented in B1000 DMSIT. 
: They may not be included in a ‘selection expression>. — 


5) NULL has not been implementec as part of a <selection. 
expression>.« A statement such as | 
| SELECT AL = NULL is not allowed. 


6) An <arithmetic item> is an ites in a record of tyre NUMBER. 
Item types POPULATION and FIELD nave not been implemented in 
B1000 OMSII. | 
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7) The <current record functions> SIN» COS» TAN» EXP. LN» LOC> 
ARCSIN» ARCCOS» and ARCTAN have not teen ispiesented. 


8) Inquiry does not accept statements of the form DISPLAY AT 
<selection condition>. 4 <display List> must be included. 


<display spec2> is as follows: 


OM ED OE OD OE OH OE ee ee eS €struct ure option> cone mam me | 


i ' 
f--- VIA -----1 
1 


f--- USING ---1 


9) The FILE part of the PRINTER statewent has not been 
implemented. | 


if} The GLOBAL part of the SHE&W statement has not been 
implemented. 


11) The | DISK part of the SORT staterent hes not been 
implemented. 


i2) EDITs say not be executed from defines. 
13) The DATA part of the <structure option> has not teen 


implemented. 


14) The subscripts in an <occurs segwent> are required to be 
integer constants. A simpde cccurring iter may have = an 
expression as its subscript. 


ITEMS LEFT 10 BE SPECIFIED 


1) To break out of a long operations ?BRK» 2BREAK» BRK» or 
BREAK may be entered. 3 


é) File names with special characters such as "»" need to te 


quoted. For examples SAVE ABC.DEF would not works but SAVE 
WABCDEF™ would. | ; 
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OVERALL STRUCTURE 
COMS/ INQUIRY consists of three basic components: 


1) DMS/BUILCING» the BUILD INQUIRY program: This program must 
te run after the database has been created with DASDL» anda 
before DFS/INQUIRY is run. It witd ask the user for the 
name of the physical database» and optionaily the name of a 
logical datahase within that physical database. It witt | 
then ask for a pack id on which to put the INQUIRY CONTROL 
FILE. 4 timeout time Limit and a list of usercodes which 
wilt be altowed tc inquire against this database is then 
requested. When this information has tceen acquirec»e 
CMS/BUILDING proceeds tc preduce the inauiry control fite 
named <database name>/INQCTL. 


2) CMS/INQUIRY» the INQUIRY program? An instantiation of this 
program witt exist for each user running INQUIRY. This 
progeam wiil ask the user for the nawe of the database which 

the user wants to inquire against and ensure that he is a 
valid user of that database. Reading the inauiry controt. 

fite to get a description cf the database» the program witi 
initialize its tnternal tatles and tegin processing user 
inquiries. Att INQUIRY processing is dcne by this programe 

Alt INQUIRY code is reentrant. | 


3) DMS/HELP ING» the heip fite: When the HELP verb is used in 
OMS /INQUIRY » this file is used to supply the syntax Bnae'ts 
and semantics of atl INQUIRY verbs and <syntax items>. 7 


TERMINAL TYPES 


The INQUIRY systew wild run on any terminal Conv iguratren which 
supports CANDE and SMCS (TO82C» TO8iG» TTY» etc). , 


RUNNING ENVIRONMENTS 


Goth ODMS/ENQUIRY and OMS/BUILDING may be run alone or under 4a 

message control system. When run alone Cwith onty a datacoma 
handler) the programs must be executed from the ODT» and the file 
named REMOTE gust be file equated to the proper station. When 
running under an MCS such as SMCS» no file equation 18 necessarys | 
invocation of security may require that OMS/INGUIRY 495s executed 

with a usercode. 
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OMS /BUILDING 


The 8UILO INQUIRY program takes its input from either a terminal 
or a card file. This ts controlled by progras switch 0. If Swe 
= 0 QCdefault)» then termina&i input is expected» otherwise a card 
file tabeled CARDS is expected. 3 


To execute the prograpm with no controlling #*CS>» sates at the ODT: 
EX DNS /BUILOING; FILE REMOTE NAME <name of stations 

If running under an MCS such as SMCS» enter at che users station: 
EX D¥S/BUILDINA 

If OMS/BUILDING has an entry in the SmCS/JOES file such see 
S$BUILDING EXCEPT EX OMS/BUILDINGs PR 9; 

the user way enter the SMCS command: 


SIGN ON BUILDING 


Once DOMS/BUILDING has been executed» it witl respond with: 


BLOC DMS/BUILDING MARK X.0 VERSION OS MM/DD/YY HH=MM 
wRaeaeRkaZK&AKSa KEK EAE KA KKka RR RKRKK AK kkikkkaktkhk&hkekk&k&hkk hth hkkkkhkkhhke ek k 


DATABASE NAME? CBLANK TO TERMINATE) 
Valid responses are? 


, } | — i 
i---- <database name> c-7°°>- anew enews emer ennnnn | 
| i i 
fe-~-~- ON <pack id> =--1 


If the database does not exist» or the syntax of the expression 
is incorrect» the program will respond with an error message and 
ask for another <database name>. If a null input 1s entered» the 
program wili terminate. 

Given an existing physical database» the program will query: 


TOTAL OR LOGICAL DATABASE? (BLANKS TO DEFAULT TO "TOTAL™) 


eg 


BURROUGHS CORFORATION | COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP 7 B10C3 DMS INQUIRY 
SANTA BARBARA PLANT | PeSe 2222 2566 (8) 


Valid responses are: 


! 
b-- TOTAL -----1 
i i 
i-- LOGICAL ---1 


If the response is “TOTAL"» the entire ohysicat datatase witt te 
used. If the response is “LUGICAL™» the programs responds: | 


ENTER LOGICAL DATABASE NAME 


to which the user should enter the name of a tlogicat database 
Within the physical database. Note that when a logical déetabase 
is specified» the inquiry controt file will be generated with a 
muiticfile-id containing the <Logical datatase name> instead of 
the <physicail database name>. 


After detergining the physical and possibly fogical datebase to 
te used» the crogram will ask: © 


PACK NAME FOR INQUIRY CONTROL FILE? 
CBLANKS TO DEFAULT TO SYSTEM PACK) 


If the controt file is to reside on a pack other than the systea 

disk» that pack name should be given. A blank ingrut specifies 
that the control file is to resigage cn the system diske Note that 
if OMS/BUILDING is run under a usercode» that usercode must te 
public and priviieged and should not have a default gack. 


The next question is: | 
TIMEQUT TIME LIMIT IN MINUTES? (BLANKS 10 DEFAULT TO 15) 


DOMS/ INQUIRY witl terminate the inquiry session of a user dwoee 
terminal remains inactive for a certain Length of time. This 
gives the data base administrator a chance to specify the Limit 
for ait users of this physical cr ticgical databasee. The response 
Shouid be the number of minutes which must be creater than © and 
fess than 1000. <A blank response gives the default 15 minutes. 


The last question is: 
SECURITY CHYES*™/°NO")? (BLANKS TO DEFAULT TO "NO") 
If the response is "VES"» then the ressage 


ENTER USERCODES SEPARATED BY ">." 
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is displayed» and OMS/BUILDING waits for a tist of usercodes 
which will be allowed to access the database using CMS/INQUIRY. 
Usercodes may be specified with or without parentheses. If there 
are more usercodes than witt fit on one line cf input» then each 
line except for the last one must enc with a “s" to teil 
CMS/HUILOINQ that more usercodes are to ke expected. | 


At this point» UMS/BUILOING creates the inauiry control file 
named <database mname>/INQCTL. This requires two catls to 
SORT/VSORT.j After the control file is buiit» the diatocue starts 
over» asking for a database names In this tanner» any number of 
inquiry controt files may be generated during one terminal 
sess icne 


To run DMS/8UILDING from cards» the following deck must te used: 


29EX DMS/BUILDING SWO=13 


204 CARDS. 
<card input> 
2END 
The <card infut> is freenforsat» and must confcrm to the 


following syntax chart: 


DATABASE = <physicat database name> -----7- aSeeeren Sess Sas Sa fees 
| | | j } 
fe- ON -- <pack jid> --1 
wom ween a ceece ewan anne one SS ea a A ae ee OS me Ree a ee 
i : i 
§- LOGICAL cree mn ew nm mn nem rwnwnm = <logical database name> 5 ~~! 
| i i | 7 | 
j-- DATABASE =<] 
7 om we me ee ne ee ee me oe es a om ae an me ee ae em en OF on Se on ee moe me me oe me _ - . - - ~— —_ a mm a an om mae 3 
i | | | } 
1 | { 
j= TIMEOUT. au Sea nmananummanm — =a <integer> et Se es ee ee ee ee ; ame] . 
4 | | oe | _ re 
§ | Jp<7- e208 » cena ame | | j 
1 i : i | { 


I- USERCOCES cone eennenee = sen---- <usercode> “-s45445 3 eI 
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after creating an inquiry control file with CMS/BUILDINGs the 


user say then run D¥S/INQUIRY. DMS/INQUIRY way be run either 
alones or with an MCS. If it is run alone» the program must te 
executed from the ODT and the file REMOTE must te file equated to 
the desired station. For example: 


EX DMS/INQUIRY? FI REMCTE NAME <name of station>; 


if it is run under an MCS such as SMCS» then no file equation is 
necessary. At the user station» enter: : | 


EX DNS/INQUIRY 


or if there is an entry for DMS/INQUIRY in the ScSsJ08S file 
such as: | 


SINQUIRY EXCEPT 3 EX DNS/INGUIRYS 
the user may enter the SMCS comgand: | 
ON INQUIRY 
Once the program has been executed it will identify pace: ant 


if the <database name> has not been supplied with the ‘7QN" 
commands it wilt ask for the name of the database to be inaguired 


against. 


E1090 DMS/INQUIRY MARK X.9 VERSION 08 CMM/DD/YY HHIMM) 
WHAT DATABASE? -_ 


4t this point» the user must enter the name of the database in 
the form: | | 7 | 


a: om €database name> SSS SSS OS SS ee ee oe oe eT 


1 | 7 4 { 
1 | _ | few" ON “"" <pack id> wr7"1 ff 
i i... - 7 ] 
Brn BYE te ren n noe ween nnn nen e renew ewe een eer enny 
If the <database name> or <pack id> contain any specialt_ 
characters or do not start with an alphabetic character» they 


must be enclosed in quotes. The <database name> should be either — 


the physical database name» or if processing against a togicat 
database» the togical database names The <pack id> is the <pack 
td> specified during OMS/BUILDING in response to the question 
“PACK NAME FOR INQUIRY CONTROL FILE?"» which way or may not be 

the same <pack id> on which the database dictionary existse If | 
the "CN <pack id>” is not specified» the system disk is default. — 
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If BYE is specified» and no databéese named BYE exists» 


OMS/INQUIRY will terminate. If using the SMCS "ON" cogmands the 


name of the database may te anpended to the sign on as in this 
exanple: | | | : 


ON INQUIRY INVENTORY ON USERPACK 


If the inquiry control does not exist» then DES/INGUIRY prompts 
for another database name. Otherwise» if security checking was 
specified during DMS/BUILDINQ» the fist of vatid usercodes for 
this database is searched for the usercode that ODM¥S/INGUIRY is 
being executed under. If the usercode appears in the tists then 
access is granted» otherwise OMS/INQUIRY aborts with a security 
error. 


If access is granted» then the gprogranr respends with: 
INITIALIZING. «PLEASE WAlToee 


and proceeds to open the database. then the database has been 
successfully opened» the user is notified by the following 
messaqe: | 


oe 2eREACY 
t 


At this point» DMS/INQUIRY is ready to process user requests. If 

no user input is received for the specified timeout tire Limit» 
then CMS/INQUIRY will terminate. If during a tiweouts» there are 
any unsaved DEFINEs» VIRTUALs» or GENERATES» they are SAVEd in a 
fiie named TIMEOQUTnnn> where nnn is the LSN of the station. 
These may tater be restored with the RESTCGRE conmand.- 
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MEMORY REQUIREMENTS 


OMS/ INQUIRY uses dynamic mesory very heavilye As a results the 
user can control the size and performance of the INQUIRY jot. 
DMS/INQUIRY is released with 2399025 bits of dynaeeic memory. 
Ailocation cf more memory dees very tittle to improve 
performances and the number of data overlays start to rise if 
less than 20G600° bit is altocated. OMS/SINQUIRY will run with as 
Litctcde as 109009 bits of dynanic menory>» depending upon which 
constructs are used. However» the nunber of data overlays at 
this point become overwhelming. If memory space its at 4 
preminun» reasonable performance say be ottained by running 
CMS/ INQUIRY with 150003 tits of dynamic memcry.e This will cause 
the elapsed time for a given request to be satisfied to degrade 
by approximately 353%. This is mainly because it wiit require 
acproximately 5 times the nugber of data overtayss» which will 
adversely affect the response times for ail other proaqrams in the 
mix. To change the ammount of cdynaric mesory add "FME nnrnnnn™ to 
the execute statement» for example: 


EX OMS/INQUIRY? ME 152009 
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TESTING FEATURES 


In order to ease testing of DMS/INQUIRY» a feature has been addec 
that enables input to be received from a disk fites»s and output to 
be printed on the tine printere If SW9 = 1» then this feature is 
invoked. : 


The disk fite may have sequence rusbers in cofugens 73785. A 
nor@al CANDE SEQ file is easiest to tse here. The internal name 
of this file is COMMANDS. To use this feature enter: 

EX DMS/INGQUIRY SW9=1s FI CUMMANDS NAME <name of input file>; 


Qutout to the printer witli be formatted as if it were being sent 
tc a 10830 (24 lines per page» &3 characters per Line)-« 


ao aad) | 
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DEBUG COMMANDS 


There are three debugging commands: DUMP»  CEBRUG and ANALYZE. 
Theis syntax and semantics may change at any tie. 


The DUMP command prints some cf inquiry*’s dynamic internal tables 
on the terminal. | 


The DEBUG command sets anc resets various internat debugging 


booleans which may result in dtagnostic output being printed 
slong with the normal output. | 


The ANALYZE command creates a printer Listing of alt the static 
information within tables created by OMS/BUILOING. 


The current syntax for the OUMP command is: 


j C= nen aemenmaew ae ae ae 1 


DUMP aanwnanae wen VCR on sos amoaeanaman | 


--- 
j--7- ys mm wf 
a‘ 1 


Pees VOT <1 | 
The current semantics of the various DUMP options are as follows: 
VCR Duaps the Virtual Current ®ecord tattle to the terminal. 
VS Dumps the Value Space table tc the terminal. 


VOT Dusaps the Virtual Define and Tempset table to the terminal. 
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The current syntax for the DE®UG command is: 


The 


fotl 


TRAC 
PYRA 


SCAN 


DEBUG 


current 


OWS: 


E 


CE 


se--- SET 


information 
set» that 


If this is set in addition to TRACE» ~~ the 
output 
terminal. 


Each 
infermation su 


RESET 


semantics 


1s 


token 


tables. 


to 


of the 


jo-- 


J 


cisplay 
infor maticn 


HELP Sse sees see 4 


various 


1 
TRACE we eeenen-e--] 
— ow . j 
PIRACE -----------t 
an mmm } 


STAN anew ananaw om = j 


=o en a mm eh ee we we = ? SS @ Ome eee ane wm ee 


a ' 
(ae: euebienioeasetea 
RES aivnielennveterinat 
DERUG2 ------- i. 
feo eseeeeeseeet 
DERUCS eeeeeseneee 
ee 
PITDUMP ee eee 
aEoneie erento 
STACKS eee ee 
sine | i 


ALL tne enn en enone) 


OPTIONS -22-------1 


DEBUC 


is displayec. 


options 


are as 


Most major routines within OMS/INGUIRY have some trace 


on the terminal. if this is 


diagnostic 


sent te the printer file instead of the 


scanned 


45 


displayed» 
ch as token type» 


along 


with any 
anc pointers into name 
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icc Each Line of tnput is written te the rrinter file as 4a 
history of what has been done in this terminal session. 

DEBUG! =“nables tracing of the WRITE_LINE routine to the 

| printere | 

DE BU G2 To be specified 

DE8UG2 To te specified 

CE BUGS To ke specified 


EFRORDOUMP Causes CMS/INQUIKY to take a dump at every ERROR 
messagee 


PITOUSP Causes DMS/INGUIRY to dump the TPIT CTesporary Potish 
Information Table)» OFT CDisplay Fermat Table), PTT 
CPolish Information Tabled» RFT (Report Format Table)». 
SCT (Setection Controt Table)» and Set (Summary 
Execution Table) during each SELECT» OISFLAY» SUMMARY > 
GENERATE» and REPORT statement. 


IDLQOKUF Causes OMS/INQUIFY to display infersation each time an 
attempt ts made to Look up an identifier in either the 
VDT table or the DBN table. 


STACKS Causes OMS/INQUIRKY to display ait stack operations 
while within the SELECT_THIS_RECORD routine. This 
Shows all calculaticns for any expressions evaluated Ly 


DMNS/INGUIRY to satisfy DISPL4Y» GENERATE REPORT ana 
SELECT statements. 


ALL Either SETS or RESETS all of the cebue options. 
KELP. Gives a hetp wessage listing each option 


GCPTIONS <dFTIONS is the same as HELP 


Srcecifying DEEUG only Cwith no options) cisplays the current 
settings of each debug option. | | 


The current syntax for the ANALYZE command is: 


ANALYZE cnn--------- lethal 


The current semantics for the ANALYZE coggand are: 


When ANALYZE is entered» OMS/INQUIRY prints» in a readable form 
the information that it received by reading the itnaquiry control 
file. This serves as an tinquiry cortroel file anatyzer. If 
CMS/ INQUIRY reads incorrect data frea the control file» then very 
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control file may be due to 
corruption by the system. 
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The incorrect data in the inaguiry 
bug in OMS/BUILDING> or to 
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